ヒアドキュメントを使ってAWS CLIの –cli-input パラメーターを便利に使う

Import-Module AWS.Tools.EC2
Import-Module AWS.Tools.SimpleSystemsManagement

# 例) New-EC2Instance でEC2インスタンスを作成する
#     多数のパラメーターを扱うときはスプラッティングを使い $params 変数にパラメーターの内容を記述
$params = @{
    KeyName = 'my-ec2-keypair'
    ImageId = $(Get-SSMParameter -Name /aws/service/ami-windows-latest/Windows_Server-2019-Japanese-Full-Base -Region ap-northeast-1 -Select Parameter.Value)
    InstanceType = 't3.medium'
    MinCount = 1
    MaxCount = 1
    SubnetId = (Get-EC2Subnet -Filter @{Name = 'tag:Name'; Values = 'my-subnet-name'}).SubnetId
    SecurityGroupId = (Get-EC2SecurityGroup -Filter @{Name = 'group-name'; Values = 'my-security-group-name'}).GroupId
    EbsOptimized = $false
    BlockDeviceMapping = [Amazon.EC2.Model.BlockDeviceMapping]@{
        DeviceName = '/dev/sda1'
        Ebs = @{
            VolumeType = 'gp2'
            VolumeSize = 30
            DeleteOnTermination = $true
        }
    }
    TagSpecification = @{
        ResourceType = 'Instance';
        Tags         = @( @{Key = 'Name'; value = 'my-windows-server-2019'});
    }
}
New-EC2Instance @params

{
    "Filters": [
        { "Name": "architecture", "Values": [ "x86_64" ] },
        { "Name": "name", "Values": [ "amzn2-ami-hvm*" ] }
    ],
    "Owners": [ "amazon" ]
}

# parameters.json がカレントディレクトリにある場合の指定例
# ※--queryパラメーターは表示の都合で記述している
aws ec2 describe-images --cli-input-json file://./parameters.json \
    --query 'reverse(sort_by(Images, &CreationDate))[0].{Architecture:Architecture, CreationDate:CreationDate, ImageId:ImageId, Name:Name}'

# params変数にJSONの内容を設定
params=$(cat <<EOM
{
    "Filters": [
        { "Name": "architecture", "Values": [ "x86_64" ] },
        { "Name": "name", "Values": [ "amzn2-ami-hvm*" ] }
    ],
    "Owners": [ "amazon" ]
}
EOM
)
# --cli-input-json パラメーターはJSONを直接指定可能
aws ec2 describe-images --cli-input-json "$params" \
    --query 'reverse(sort_by(Images, &CreationDate))[0].{Architecture:Architecture, CreationDate:CreationDate, ImageId:ImageId, Name:Name}'

# params変数にYAMLの内容を設定
params=$(cat <<EOM
Filters:
- Name: 'architecture'
  Values:
  - 'x86_64'
- Name: 'name'
  Values:
  - 'amzn2-ami-hvm*' # serach Amazon Linux 2
Owners:
- 'amazon'
EOM
)
# --cli-input-yaml パラメーターはYAMLを直接指定可能
aws ec2 describe-images --cli-input-yaml "$params" \
    --query 'reverse(sort_by(Images, &CreationDate))[0].{Architecture:Architecture, CreationDate:CreationDate, ImageId:ImageId, Name:Name}'

$params = @'
{
    "Filters": [
        { "Name": "architecture", "Values": [ "x86_64" ] },
        { "Name": "name", "Values": [ "amzn2-ami-hvm*" ] }
    ],
    "Owners": [ "amazon" ]
}
'@

# PowerShell → awsコマンドに渡す際はダブルクォートのエスケープが必要
# -replace演算子を使って一括エスケープ
$params = @'
{
    "Filters": [
        { "Name": "architecture", "Values": [ "x86_64" ] },
        { "Name": "name", "Values": [ "amzn2-ami-hvm*" ] }
    ],
    "Owners": [ "amazon" ]
}
'@ -replace '"','\"'
# --cli-input-json パラメーターはJSONを直接指定可能
aws ec2 describe-images --cli-input-json $params `
    --query 'reverse(sort_by(Images, &CreationDate))[0].{Architecture:Architecture, CreationDate:CreationDate, ImageId:ImageId, Name:Name}'

{
    \"Filters\": [
        { \"Name\": \"architecture\", \"Values\": [ \"x86_64\" ] },
        { \"Name\": \"name\", \"Values\": [ \"amzn2-ami-hvm*\" ] }
    ],
    \"Owners\": [ \"amazon\" ]
}

# YAMLではダブルクォートは必須ではないのでエスケープ不要
# (※もちろんダブルクォートを使った場合は要エスケープ)
$params = @'
Filters:
- Name: 'architecture'
  Values:
  - 'x86_64'
- Name: 'name'
  Values:
  - 'amzn2-ami-hvm*' # serach Amazon Linux 2
Owners:
- 'amazon'
'@
# --cli-input-yaml パラメーターはYAMLを直接指定可能
aws ec2 describe-images --cli-input-yaml $params `
    --query 'reverse(sort_by(Images, &CreationDate))[0].{Architecture:Architecture, CreationDate:CreationDate, ImageId:ImageId, Name:Name}'

$params = @{
    Filter = (
        @{ Name = 'architecture'; Values = 'x86_64'},
        @{ Name = 'name'; Values = 'amzn2-ami-hvm*'}
    );
    Owner = 'amazon'
}
Get-EC2Image @params |
    Sort-Object CreationDate -Descending | Select-Object Architecture, CreationDate, ImageId, Name -First 1

# NG : PowerShell 7.3以降ではJSONをエスケープしてはダメ
$params = @'
{
    "Filters": [
        { "Name": "architecture", "Values": [ "x86_64" ] },
        { "Name": "name", "Values": [ "amzn2-ami-hvm*" ] }
    ],
    "Owners": [ "amazon" ]
}
'@ -replace '"','\"' # -replace 演算子は不要

# OK : PowerShell 7.3以降の場合はこれで良い
$params = @'
{
    "Filters": [
        { "Name": "architecture", "Values": [ "x86_64" ] },
        { "Name": "name", "Values": [ "amzn2-ami-hvm*" ] }
    ],
    "Owners": [ "amazon" ]
}
'@